メルペイ決済 インタフェース
概要
リンクタイプ Plus決済では、決済手段としてメルペイ決済を利用することが可能です。メルペイ決済を利用するには、実行パラメータセットにメルペイ決済に必要なパラメータを渡す必要があります。
リンクタイプ Plus決済でメルペイ決済が完了すると、遷移先URLにメルペイ決済の結果パラメータが返却されます。
遷移先URLは設定により異なるパラメータを参照します。
詳細は「決済画面からの加盟店様サイトへの遷移」をご覧ください。
入出力パラメータ仕様
実行パラメータ仕様
メルペイ決済固有の実行パラメータは以下の通りです。
| json key | 詳細 | 指定可能箇所 | システムデフォルト設定 | |||
|---|---|---|---|---|---|---|
| リンクタイプPlus決済URL | 加盟店デフォルト設定 | |||||
| merpay |
メルペイ決済固有実行パラメータメルペイ決済の実行パラメータセットです。 |
〇 | 〇 | (null) | ||
| JobCd | 必須
処理区分以下のいずれかを設定します。AUTH:仮売上 CAPTURE:即時売上 |
〇 | 〇 | AUTH | ||
| TaxCalcFlag | 半角数字1桁 固定
税送料算出方法以下のいずれかが設定可能です。0:固定 1:後から算出 「1：後から算出」を選択した場合、ユーザが決済処理を行った際、税送料計算URL（TaxCalcURL）で指定したURLにマルペイサーバーから送信する配送先情報を元に税送料を算出する必要があります。 ※個人情報利用契約がある加盟店のみ利用できます。 |
〇 | 〇 | (null) | ||
| TaxCalcURL | 半角英数記号256桁
税送料計算URL税送料算出方法に「1：後から算出」を指定した場合、必須入力です。※個人情報利用契約がある加盟店のみ利用できます。 |
〇 | 〇 | (null) | ||
| DeliveryAddressFlag | 半角数字1桁 固定
個人情報利用フラグ以下のいずれかが設定可能です。0:利用しない 1:使用する 「1：利用する」を選択した場合、配送先情報を参照できるようになります。 ※個人情報利用契約がある加盟店のみ利用できます。 |
〇 | 〇 | (null) | ||
| Items | 必須
商品情報JSON形式で指定してください。最大20件まで指定可能です。・設定例（商品カテゴリIDが1つの場合） "Items": [ { "Name":"トップス", "ListPrice":"1500", "CategoryId":"1010" } ] ・設定例（商品カテゴリIDが複数の場合） "Items": [ { "Name":"トップス", "ListPrice":"1500", "CategoryId":"1010" }, { "Name":"ボトムス", "ImageUrls":["https//xxx.xx","https//yyy.yy"], "ListPrice":"11000", "CategoryId":"1011" } ] |
〇 | - | (null) | ||
| Name |
商品名文字数制限はございません。半角英数字、半角記号(除く ^ ` { | } ~ & < > " ' )、全角文字が使用可能です。 |
〇 | - | (null) | ||
| Description |
商品説明文字数制限はございません。半角英数字、半角記号(除く ^ ` { | } ~ & < > " ' )、全角文字が使用可能です。 |
〇 | - | (null) | ||
| ImageUrls |
商品画像URL一覧最大9件、1件あたり256桁まで指定できます。 |
〇 | - | (null) | ||
| Category | 全半角40桁
カテゴリ名 |
〇 | - | (null) | ||
| Size | 全半角40桁
サイズ |
〇 | - | (null) | ||
| Brand | 全半角40桁
ブランド名 |
〇 | - | (null) | ||
| Color | 全半角40桁
色 |
〇 | - | (null) | ||
| ListPrice | 半角数字7桁
定価 |
〇 | - | (null) | ||
| UnitPrice | 半角数字7桁
購入時価格 |
〇 | - | (null) | ||
| Quantity | 半角数字4桁
購入数 |
〇 | - | (null) | ||
| ItemCode | 全半角40桁
製品管理コード |
〇 | - | (null) | ||
| JanCode | 半角数字13桁
JANコード |
〇 | - | (null) | ||
| CategoryId | 必須半角英数4桁
商品カテゴリID
本項目はメルペイの決済手段のひとつであるメルペイスマート払いとメルペイかんたん出品連携機能を利用するために必要な情報となります。 |
〇 | - | (null) | ||
| HttpUserAgent |
ユーザーエージェントお客様端末のUserAgentを指定します。メルペイにて流入経路解析に使用されます。 |
〇 | - | (null) | ||
※設定可能な文字については「メルペイマニュアル」を参照してください。
結果パラメータ仕様
メルペイ決済を選択した場合に、加盟店様に返却するメルペイ決済固有の結果パラメータは以下の通りです。
| merpay |
メルペイ決済固有部メルペイ決済固有の結果パラメータセットです。 |
|
|---|---|---|
| Status |
取引状態取引の状態を示す以下の値が設定されます。REQSUCCESS:決済が未完了の状態 AUTH:仮売上が正常に完了した状態 CAPTURE:即時売上が正常に完了した状態 PAYFAIL:決済失敗（決済がエラーとなり支払いに失敗してしまった状態。お客様による支払い中断や、システムトラブル等の何らかの原因でお支払いに失敗してしまった状態） |
|
| MerpayInquiryCode | 半角数字12桁
メルペイ取引番号メルペイの取引を特定するための番号が設定されます。 |
|
| MerpayCancelAmount | 半角数字7桁
キャンセル金額キャンセル時の金額が設定されます。 |
|
| MerpayCancelTax | 半角数字7桁
キャンセル税送料キャンセル時の税送料が設定されます。 |
|
| TranDate | 半角数字14桁
決済日時決済を行った日時が設定されます。（yyyyMMddHHmmss形式） |
|